home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Communications / General / Ballot Box Folder / Ballot Box Instructions.txt < prev    next >
Text File  |  1994-05-09  |  13KB  |  260 lines

  1.  
  2. Ballot Box v1.2
  3. written by: David Woodall
  4. distributed by Computer Classifieds
  5.  
  6.  
  7. Welcome to the Ballot Box instruction file.
  8.  
  9. Features of Version 1.0:
  10. - 20 Questions available 
  11. - 15 answers per question
  12. - Ability to list a question's stats. only after the question is voted on.
  13. - Set Security Level for Ballot Box
  14. - Set Access Level for Ballot Box
  15. - Set the Security Level and Access Letter for each question
  16. - Delete Questions
  17. - Modify Questions with out changing percentages
  18. - You can set the Security Level for a Sysop
  19. - You can set the minimum Security Level to Add a question
  20. - Two options pertain to a user with the above mentioned Security 
  21.    Level, Manual or Auto release. 
  22. - Set the logon option to either force the users to vote if they have 
  23.    questions they have not voted on, they cannot 
  24.    quit until all questions have been voted on, or give the user the 
  25.    choice to answer the new questions if they 
  26.    wish to or give the users no notification of new questions.
  27.  
  28. Additions of Version 1.1:
  29. -2 Lines per Question.
  30. -Output Question stats to Text File. Either manually or at a specified 
  31.   time.
  32. -Log more stuff in the Hermes Logs.
  33. -Controllable option for screen clears when Ballot Box is accessed.
  34. -Added help file for users.
  35. -Fixed bug in selecting question w/access letter.
  36. -V now only works from the main menu.
  37.  
  38. Additions of Version 1.1.x:
  39. -Fixed Logon Problem with the Notify Option Set. Now only asks once.
  40. -Fixed logging of **Ballot Box v1.1.1** accessed in todays log.
  41. -Changed Omit option slightly.  Now on logon it displays the question numbers that you have not voted on yet.
  42.  
  43. Additions of Version 1.2:
  44. -Added ability to output the results of a question to a text file or a    
  45.   tab delimited file.
  46. -Ballot Box will now create the needed folder.
  47. -Cleaned up code.
  48.  
  49. Installation:
  50.     1.  Quit Hermes.
  51.     2.  Place the file Ballot Box v1.2 into the Externals folder.
  52.     3.  In the Externals folder create a empty folder and name it 
  53.          Ballot Folder.  If you fail to make a folder or type the name          of the folder incorrectly the program will not work.
  54.     4.  Run Hermes.
  55.     5.  Logon as the Sysop.  There will be a pause after the 
  56.          automessage and you will be notified that Ballot Box is 
  57.          creating a user file.    
  58.  
  59.     The installation process is complete.  All necessary files have 
  60.     been created and placed into the folder you created named 
  61.     Ballot Folder.  If you have any problems you probably named 
  62.     the folder incorrectly.  Now refer to the Setup section for 
  63.     further operations.
  64.  
  65.  
  66. Setup:
  67.     Once the Sysop is logged onto the BBS, Ballot Box can be     configured.  The program can either be accessed by typing V at     the main menu prompt or by selecting the external in the     externals menu.
  68.  
  69.     You may then select the option C to enter the configure menu.     This is what you will see.
  70.  
  71. <--------------------- Configure Menu ------------------------------->
  72.  
  73.            < A >     Add a Question
  74.            < M >     Modify a Question or Answer
  75.            < D >     Delete a Question
  76.            < V >     Min. SL for Ballot Box          0
  77.            < L >     Access Letter for Ballot Box    No Access Letter
  78.            < S >     SL for Configure Menu           255
  79.            < P >     SL to Add Question              255
  80.            < R >     User Question Release           Manual
  81.            < F >     Set Logon Option                Omit
  82.            < C >     Screen Clear On Logon           Yes
  83.            < O >     Output Question To Text File
  84.         < W >     Output User Votes to Text File
  85.            < E >     Register Ballot Box
  86.            < Q >     Quit Configure Menu
  87.  
  88. Selection :                                                           
  89.  
  90.  
  91.  
  92.     These are the available options in Ballot Box. I will now discuss     each option.
  93.  
  94. Option A:
  95.     Using this option you can add a question.  You are first     prompted to enter the question, you have an available space of     160 characters.  You have 2 lines of text available.  The text     will not wrap.  When you get to the end  of the first line you     need to hit CR and then you can begin typing the second line.      If you question is only one line long just hit CR twice.  Hitting     <CR> at this prompt with no text typed, will quit the Add     sequence and return you to the Configure menu.
  96.  
  97.     After typing in the question you will be asked to enter the     answers.  You have room for 15 answers each with an available     space of 45 characters.  When you are done entering your     answers simply hit <CR> on a blank line to proceed to the next     option.
  98.  
  99.     You are then prompted to enter a Security level for the
  100.     question.  Striking <CR> at this point will result in setting the     Security level to 1 for this question.
  101.  
  102.     The next prompt is for an access letter for the question.      Striking <CR> at this point will result in setting the access letter     to nothing.
  103.  
  104.     You have now entered a question and users can vote on it.
  105.  
  106. Option M:
  107.     Selecting M will first bring up a list of the current questions. A     star next to the question number simply means you have not     voted on it.  A question mark next to the question number     means a question has not been released yet.
  108.  
  109.     Select the question you want to modify.  You are then able to     modify anything about the question.  Note:  You cannot add an     answer or remove one.  If you wish to do so you must delete     the question and retype it.
  110.  
  111.     Again if you hit <CR> when you select the Access Letter for the     question Ballot Box will set the Access Letter to nothing.
  112.  
  113.     The released option is simply a toggle.  Released: Yes means     that a question is available to be voted on by any user who     meets the SL and Access Letter required by it.
  114.  
  115. Option D:
  116.     Use this option to delete a question.  Once a question is deleted     it cannot be recovered. NOTE: This operation may take a second     due to the fact that all of the users records are adjusted.  With     a user list of 917 this process takes approximately 3 seconds.
  117.  
  118. Option  V:
  119.     This option sets the minimum security level that a user must     have to access Ballot Box through the main menu or the     externals menu.  The current setting is depicted on screen.
  120.  
  121. Option L:
  122.     This option sets the access letter that a user must have to     access Ballot Box through the main menu or the externals     menu.  The current setting is depicted on screen.
  123.  
  124. Option S:
  125.     This option sets the minimum security level for the configure     menu.  This is a security level you could use for co-sysop's.      The current setting is depicted on screen.
  126.  
  127. Option P:
  128.     This is the minimum security level required to add a question.      This allows you to let the users (if they so choose) to enter     their own questions.  An option that goes hand in hand with     this option is Option R.  Please refer to this description for 
  129.     further information.  The current setting is depicted on screen.
  130.  
  131. Option R:
  132.     This option has two choices, Auto or Manual.  These have to do     with the users entering questions.  If you wish to allow your     users to enter questions you have two choices of how to do this.      If you select auto then the questions entered by the users are     automatically released for the users to vote on.  The minimum     security level to vote and access letter are set to the minimum     security level for Ballot Box and access letter for Ballot Box (see     options V and L).
  133.  
  134.     If you select  Manual then the questions have to be released by     you or a co-sysop.  When a user adds a question and this option     is set to Manual a message is outputted to a user     recommending him/her that they send Feedback to you     notifying you that a new question has been entered.  All     questions entered with the option set to Manual will be un-    viewable by all users until released by you.  A question is     depicted as pending by having a question mark to the left of     the question number.  To release a question to the users see     Option M.  
  135.  
  136.     The current setting is depicted on screen.
  137.  
  138. Option F:
  139.     This option is the action that Ballot Box will take upon Logon by     a user, there are three possible options:  Omit, Notify and Force.
  140.  
  141.     Using option Omit.  This will not ask or make the user vote on 
  142.     any new questions.  Ballot Box will output the numbers of the 
  143.     questions that they have not voted on.
  144.  
  145.     Using option Notify.  This will tell a user upon logon that there     are new questions they have not voted on and give them a     choice wether to vote or not.  If they say yes, the user is able to     quit out of the voting external if they so desire without having     to answer the question.
  146.  
  147.     Using option Force.  When there are new questions and a user     logs on they are unable to exit the external until all of the     questions have been voted on.
  148.  
  149.     The current setting is depicted on screen.
  150.  
  151. Option C:
  152.     This option toggles the screen clears when a user access Ballot     Box.  Put in mainly for the Force option so that the user is still     able to read the Auto Message.
  153.  
  154. Option O:
  155.     Selecting this puts you into the Text Output Menu.  Which looks     like:
  156.  
  157. Output Question to Text Menu
  158.  
  159. 1. Question #1                                                 Yes
  160. 2. Question #2                                                 No
  161.  
  162. Auto Create:                   Yes
  163. Time Ballot Box Creates Lists: 0400
  164.  
  165. [#] of Question,  [A]uto Create, [T]ime, [Q]uit:
  166.  
  167.     Selecting A will toggle the auto create option.  This option is     used to determine if Ballot Box should Auto Create lists.  If the     option is no Ballot Box will not create any lists.  Selecting T     allows you to specify the time that you want Ballot Box to auto     create the lists.  
  168.  
  169.     If you look at the question you will notice that at the right     hand side of the screen there is a Yes on one line and a No on     another.  This gives you at a glance which questions will be     Auto Created.  You have the option to decide which specific     questions you want auto created.   To change this option type     in the number of the question you wish to change.  You will     then get a menu that looks like:
  170.  
  171. Question #1
  172.  
  173. Auto Create This List: Yes
  174. Current Path:          Hard Disk 163:Hermes II:Hermes Files:
  175.  
  176. [A]uto Create, [C]hange Path, [M]ake Text Now, [Q]uit:
  177.  
  178.     Selecting A will toggle the Auto Create for this specific list.      Selecting C will allow you to type in the path of where you     want this specific list created to (The GFiles would be a good     example.).  Selecting M is your way of manually creating this     specific list, this is done immediately.
  179.  
  180. Option W:
  181.     This option allow the Sysop to output the data of each question 
  182.     to a text file.  The data is in the form of the User Number, User 
  183.     Name and choice on answer.  If the choice is 0 then the user 
  184.     has not voted on that question.
  185.  
  186. Option E:
  187.     This is the registration option.  Use this option to register your     external.  To obtain a Registration Number see the Registration     Information section of this document.
  188.  
  189. To Update from 1.0.2 to 1.1:
  190.     You need to trash all of your files located in the Ballot Folder.  Then replace Ballot Box v1.0.2 with Ballot Box v1.1.  Registered users will need to re-enter their serial number and bbs name.
  191.  
  192. REGISTRATION INFORMATION:
  193.  
  194.     This external will work for seven days. If you wish to continue using the external you will need to register it.  The cost to register this external is $10.  To register with a Credit Card (MasterCard or Visa) you can do so online at Olympus BBS.  The phone number is 206-643-2874.    You will need to include the following information in the E-Mail sent to user number 1.
  195.  
  196.         - Notify you wish to register Ballot Box.
  197.         - Your BBS name as you want depicted through Ballot Box           (64 characters max.).
  198.         - Your credit dard number.
  199.         - Your credit card's expiration date.
  200.  
  201.     Otherwise you can print out the registration application at the end of this document and send it to Computer Classifieds.  Make all checks payable to Computer Classifieds.  Once processed your registration number will be E-mailed to you on Olympus.
  202.  
  203.     NOTE: With this one time registration you will receive all upgrades of this external for free.
  204.  
  205.  
  206. A little info about Ballot Box v1.1 and the author:
  207.  
  208.     I (David Woodall) began writing this external a few weeks after graduating from college.  I worked with Lloyd Woodall in hopes to make a quality voting external available to sysop's using the Hermes program.  I believe I have succeded in doing so.   If anyone has any questions, suggestions or ideas for externals I can be reached on Olympus BBS, user number 212.  Enjoy.
  209.  
  210. Other Externals Available:
  211.     TopDL 1.0.2
  212.  
  213. DISCLAIMER:
  214.  
  215.     I hold no responsibility if this external crashes your Hermes application or computer.  In using this external you are doing so at your own risk and I am not accountable for any problems that this external may cause with you use of it.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242. Ballot Box v1.2 Registration Form
  243. Computer Classifieds
  244. 12819 S.E. 38th #101
  245. Bellevue, WA 98006
  246.  
  247.  
  248. Your Full Name : ____________________________________________________
  249.  
  250. BBS Name (As to appear in External. 64 chars. max.) :_____________________________________________
  251.  
  252. Olympus BBS User Number :_____________
  253.  
  254. Home Phone Number :_______________________________    Amount Enclosed : $ 10.00 (US Funds)
  255.  
  256.  
  257. Comments:
  258.  
  259.  
  260.